home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / jed096_1.zip / JED / INSTALL.UNX < prev    next >
Text File  |  1994-04-27  |  5KB  |  132 lines
  1. UNIX installation specific functions.  Please read this file.
  2.  
  3. 0. Building and installing JED requires that you also have the S-Lang library
  4.    to link to (cc *.c -lslang).  Build it first.  It should be in ../slang.
  5.  
  6. 1. Pick some place for JED.
  7.    JED is distributed in a TREE structure:
  8.  
  9.      JED_ROOT/
  10.      JED_ROOT/src
  11.      JED_ROOT/info
  12.      JED_ROOT/doc
  13.      JED_ROOT/lib
  14.      JED_ROOT/bin
  15.      
  16.    Here JED_ROOT can be anything (e.g., /usr/local/jed).  It must be specified
  17.    in the makefile.  It is important that the subdirectories under JED_ROOT
  18.    remain intact.  An environment variable called `JED_ROOT' can also be
  19.    created to over ride the value compiled with the executable.
  20.  
  21.    For simplicity, suppose that after you have unpacked the jed distribution,
  22.    from the directory:
  23.  
  24.                 /usr/users/myname/src
  25.      
  26.    to create:
  27.  
  28.             /usr/users/myname/src/jedxx-y
  29.  
  30.    Let's say that you want JED_ROOT to be /usr/local/jed.  Then, AFTER you
  31.    have successfully installed jed, you can simply do:
  32.  
  33.            mv /usr/users/myname/src/jedxx-y /usr/local/jed
  34.      
  35.    Better yet, simply make /usr/local/jed to be a link:
  36.  
  37.          ln -s /usr/users/myname/src/jedxx-y  /usr/local/jed
  38.          
  39.    !! Please note that if you have an old version of JED installed, remove
  40.       any environment variable called JED_LIBRARY.  It is obsolete.
  41.  
  42. 3. Build JED.
  43.    To actually build JED, move to the src directory in the JED distribution
  44.    and copy makefile.unx to makefile:
  45.  
  46.                      cp makefile.unx makefile
  47.  
  48.    Edit the makefile to reflect your system.  Instructions are in it.  This
  49.    is also the step where you must specifiy the value of JED_ROOT as
  50.    described above.
  51.    
  52.          * note:  JED assumes that the system supplied memcmp routine performs
  53.               an unsigned comparision.  This is NOT the case for SunOS.
  54.           If your system uses a signed comparison for memcmp, do not
  55.           use the -DHAS_MEMCMP option.  If you do not know, do not
  56.           use it either.
  57.    
  58.    Then type `make' at the prompt.
  59.    
  60. 3.1 
  61.  
  62.    If you want to build the XWindows version of JED, type:
  63.    
  64.       make xjed
  65.       
  66.    at the prompt (assuming you have correctly edited the makefile).
  67.  
  68. 3.2
  69.    If you would like to use JED's rmail mode, first read doc/rmail.txt.  
  70.    Then type:
  71.     
  72.         make getmail
  73.     
  74. 3.3
  75.    JED comes with a highlighting recursive grep program called rgrep. Type:
  76.         
  77.         make rgrep
  78.     
  79.    Then entering:
  80.    
  81.         ./rgrep
  82.     
  83.    will dump out a usage.  Do with it what you want.  It is useful and IMHO 
  84.    is better than grep.
  85.    
  86. 4. Copy the new executable to somewhere on your path, e.g.,
  87.  
  88.                cp ./jed /usr/local/bin
  89.                rehash
  90.  
  91. 5. Now move the distribution to the location of JED_ROOT as specified 
  92.    in the first step.
  93.    
  94. 6. By default, when JED starts up, it will load some files out of
  95.    JED_ROOT/lib then it will look for the file .jedrc in your home directory.
  96.    If it does not find it, it will load the default file from JED_ROOT/lib.
  97.    This will give you both emacs and edt emulation.  If you do not want
  98.    that, you will need to copy JED_ROOT/lib/jed.rc to $HOME/.jedrc and edit it.
  99.    
  100.    In fact, you are encouraged to copy jed.rc to $HOME/.jedrc and make your
  101.    own personal changes there.  The jed.rc file should be regarded as a
  102.    template for .jedrc and should not be changed.  Many Unix users do not
  103.    want EDT editor bindings.  However, JED is shipped with the EDT bindings
  104.    enabled.  If you do not want the EDT bindings, disable them in your .jedrc
  105.    file.
  106.  
  107.    In particular, read site.sl which is the first file loaded when JED
  108.    starts.  Site specific customization should be placed in defaults.sl. For
  109.    example, my defaults.sl on my linux system simply loads linux.sl. (See
  110.    linux.sl) This sets keybindings for the appropriate for console and sets
  111.    the color to white on blue.
  112.  
  113.    See site.sl for details.  
  114.    
  115. 8. Optional but highly recommended.  Preparse the S-Lang files.  This
  116.    is done by running JED as:
  117.      
  118.          % jed -batch -n -l preparse.sl
  119.      
  120.    This creates pre-parsed *.slc files that load quicker than *.sl files.
  121.    If this step fails to work for some reason, JED is probably not properly
  122.    installed. 
  123.    
  124. 9. Again optional: There is a JED announcement list.  If you want to be
  125.    notified of upcoming JED releases, send email to me :
  126.    
  127.        davis@amy.tch.harvard.edu
  128.        
  129. 10. That's it.  Enjoy.
  130.  
  131. --John
  132.